home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / quickrun.arc / QUICKR_2.DOC < prev    next >
Text File  |  1985-11-21  |  7KB  |  161 lines
  1.  
  2. QuickRUN      The Program Manager Shell                  by Robert Jung
  3.       Another fun 'n FREE O-MayerVare product!
  4.  
  5.                         version 2.0   Modified 6/24/1989
  6.  
  7.  
  8.  
  9. QuickRUN is Copyright 1989 by Robert Jung. This program is in the public
  10. domain and may be freely copied, as long as this text file, the program
  11. QUICKR_2.PRG, and QUICKR_2.RSC are distributed together without modification.
  12.  
  13.  
  14. ****************************************************************************
  15. * If you read nothing else, PLEASE read the last section of this doc file! *
  16. *                                                          Thank you.      *
  17. ****************************************************************************
  18.  
  19.       A version 2 salute to my best buddy, Captain Drazil;
  20.             Maurice Molyneaux, another fan of Movie Maker/Film Director;
  21.             Dave Small and David Ahl, for the old _Creative Computing_ days;
  22.             and all the people who wrote me or call the O-Mayer V BBS.
  23.  
  24.  
  25. WHAT IS QUICKRUN?
  26. =================
  27.  
  28.       If you have a hard drive, you've probably got your files organized into
  29. different partitions and directories. While that's really neat, it can be a
  30. real hassle : Either the program you want is nested seven folders deep, or you
  31. have to scroll through dozens of data files to find it.
  32.  
  33.       QuickRUN is a program manager -- You build lists of ST programs, which
  34. can then be executed from QuickRUN instead of the Desktop. It doesn't matter
  35. what the program is, if it's a legal ST TOS program, you can run it with
  36. QuickRUN. And since QuickRUN is only 18K, it doesn't eat up your memory.
  37.  
  38.       Imagine, just click on FLASH.PRG, and let QuickRUN find it for you!
  39. Stick all your games in one list, and run them together conviently! Put your
  40. editor, compiler, linker, debugger, assembler, and other tools all in one list,
  41. and avoid hopping between windows, folders, or drives. Or use QuickRUN with the
  42. "Universal Item Selector", put ALL of your ST programs in a list, and use
  43. QuickRUN as an alternate Desktop!
  44.  
  45.  
  46. STARTING QUICKRUN
  47. =================
  48.       To get started, run the file QUICKR_2.PRG. This is a GEM-based program,
  49. so you'll have to either run it from the Desktop, use the auto-execute feature
  50. of TOS 1.4, or have STARTGEM run it for you automatically (see elsewhere in
  51. this archive for information on STARTGEM).
  52.  
  53.       QuickRUN will try to load the file QUICKR_2.RSC. If it is not in the
  54. same drive/directory as QUICKR_2.PRG, the program will not load.
  55.  
  56.       If there is a file called DEFAULT.QRL in the same drive/directory as
  57. QUICKR_2.PRG, it will be automatically loaded in.
  58.  
  59.       When QuickRUN is ready, you'll see the main dialog box. There's a
  60. scrollable window on the left, and a bunch of buttons on the right. Everything
  61. in QuickRUN is activated by a button, which activates a command :
  62.  
  63.   HELP    -- QuickRUN help and information.
  64.   ADD     -- Adds a new program to QuickRUN.
  65.   EDIT    -- Update an existing entry.
  66.   CLEAR   -- Gets rid of one entry, or the entire list.
  67.   ORDER   -- Alphabetizes all entries for ease of searching.
  68.   LOAD    -- Loads a QuickRUN list.
  69.   SAVE    -- Saves the current QuickRUN listing to disk.
  70.   RUN     -- Executes the currently selected program.
  71.   QUIT    -- Leaves QuickRUN.
  72.  
  73.       You can run a command by either clicking on the button, or pressing the
  74. first letter of that command on the keyboard.
  75.  
  76.       You can scroll through the list with the arrows/scroll bar, or by
  77. pressing the up/down arrow keys. Pressing the arrow keys by themselves will
  78. scroll the list by one name. Pressing the arrow keys with the SHIFT key held
  79. down will scroll the list in increments of 20.
  80.  
  81.       You can select a file to operate with, by clicking it with the mouse, or
  82. by pressing F1 - F10 (for files numbered 1 through 10) or SHIFT and F1 - F10
  83. (for files numbered 11 through 20).
  84.  
  85.       For all commands, information is provided either by a dialog box on the
  86. screen, or a "what-you-should-do" line at the top of the screen.
  87.  
  88.  
  89. QUICKRUN COMMANDS
  90. =================
  91.  
  92.       ADD lets you put a new program into the current list. With the ST file
  93. selector box, click on the program you want to add. When you actually run the
  94. program with QuickRUN, it'll use the path (drive and directory nesting) you
  95. specify here.
  96.  
  97.       EDIT will let you update a listing entry. Click on the filename you want
  98. to update, then click on EDIT. You can then use the file selector box to choose
  99. a new filename/path for that entry, just like with ADD.
  100.  
  101.       CLEAR gets rid of listing entries. If you have no filename already
  102. chosen, CLEAR will allow you to clear the entire list currently in memory. If
  103. you do have a filename chosen, you can either clear the entire list or just
  104. that one entry. 
  105.  
  106.       ORDER will alphabetize the QuickRUN list currently in memory. Once a
  107. list is alphabetized, there's no way to "un-alphabetize" it, so be sure you
  108. want to do this.
  109.  
  110.       LOAD puts a new QuickRUN list into memory. Loading a list will get rid
  111. of anything you already have, so be careful! Only QuickRUN-generated lists can
  112. be loaded; any attempt to load an illegal file will be cancelled.
  113.  
  114.       SAVE writes the list currently in memory onto the disk. If you have
  115. nothing in the list, the command is ignored. Any filename can be used for a
  116. QuickRUN list, but if no extender is specified, ".QRL" will be automatically
  117. tagged on.
  118.  
  119.       RUN will execute the currently selected file; this will work exactly as
  120. if you had run it from the GEM Desktop. If the program is not in the
  121. directory/path it's suppoed to be (as specified with ADD or EDIT commands),
  122. QuickRUN will not run it.
  123.  
  124.       QUIT leaves QuickRUN. Anything you have in memory will be erased, so be
  125. sure to SAVE your work first.
  126.  
  127.  
  128. WHAT ELSE IS THERE?
  129. ===================
  130.  
  131.       To tell the truth, there's not much else I can think of to say about
  132. QuickRUN. All of the commands are obvious, and there are warning prompts
  133. before anything disasterous can happen.
  134.  
  135.       The only limit to how many programs you can have in a QuickRUN list is
  136. the amount of free memory you have. If QuickRUN doesn't have the memory for a
  137. new entry, there's probably not enough memory left to execute anything anyway.
  138.  
  139.       QuickRUN works with the "Install Application" feature of the ST Desktop.
  140. If you use this feature in conjunction with DEFAULT.QRL, the file you selected
  141. will be loaded, and not DEFAULT.
  142.  
  143.       This program is completely free, but I really, REALLY, *REALLY* want
  144. some user feedback! Drop me a postcard or something at the address below, so I
  145. know that SOMEBODY is actually seeing these things I write. I don't care if you
  146. have nothing to say, just write SOMETHING. It really makes my day to know that
  147. someone actually read this file, and not just skipped over it.
  148.  
  149.       Send comments, suggestions, complaints, questions, bribes, or whatever to
  150.  
  151.                             Robert Jung
  152.                             740 South Orange Drive
  153.                             Los Angeles, CA  90036
  154.  
  155.       Or (even better!) contact me through
  156.  
  157.                              THE O-MAYER V BBS
  158.                              (213) 732-0229
  159.                              1200-2400 baud, 24 hours
  160.                              Atari ST/XE, Spectre 128, PC Ditto
  161.